iT邦幫忙

2025 iThome 鐵人賽

DAY 6
1

Kira 主題核心(node_modules/hexo-theme-kira/

今天不用做任何事就看對照表而已
之後有要修改不知道要改哪個檔案都能回來這邊看

路徑 / 範例檔名 作用 影響頁面 自訂建議 / 備註
layout/index.ejs 首頁框架(封面、文章列表) 首頁 增加共用元件。
layout/post.ejs 單篇文章版型 文章頁 文章內資訊欄、目錄、標籤顯示都在這控制。
layout/archives.ejs 歸檔頁版型 /archives 改排序或群組樣式。
layout/about.ejs 自我介紹頁 /about 點頭像跳轉到自介頁會連到這個 layout。
layout/friends.ejs 友鏈頁版型 /friends 卡片樣式、分欄、載入圖都在這裡。
layout/components/sidebar.ejs 側欄結構(頭像、社交、分類…) 所有頁 滑鼠移到頭像旋轉、點擊跳轉事件可在這裡掛。
layout/components/header.ejs 頂部導覽列 所有頁 更改頭像特效與設定
layout/_widget/social.ejs 社交連結渲染 所有頁 讀取主題設定的社交清單;換 icon/新增平台
languages/*.yml 多語系字串 所有頁 介面文字翻譯;臺灣繁中用 zh-TW.yml
source/css/layout.styl 主要版面排版 所有頁 不直接修改這個文檔,而是引用 source/style.css 將新增的介面加在這邊
source/css/post.styl 文章區塊樣式 文章頁 文章區標題、引用、程式碼區塊樣式。
source/css/sidebar.styl 側欄樣式 所有頁 頭像外框、hover 動畫、社群列版面。
source/js/kira-code-copy.js 程式碼複製按鈕 文章頁 更改按鈕圖示或文案。
source/js/kira-image.js 圖片互動/燈箱 圖片元素 若要禁用某些頁的燈箱,這裡可加判斷。
source/lib/iconfont/* 圖示字型與示例頁 所有頁 放 SVG/Iconfont;可替換為官方 SVG。
source/lib/lazysizes/* 圖片延遲載入 有圖頁面 若相容性問題,版本在這。
scripts/tag/*.js Hexo 自訂標籤(aplayer、bilibili、codepen…) Markdown 文章中使用 {% aplayer %} 等標籤時由這裡產生 HTML。
package.json / README / LICENSE 主題資訊與授權 了解相依與用法。

站點(專案根目錄)

路徑 / 檔名 作用 影響頁面 自訂建議 / 備註
_config.yml 站點總設定(標題、語系、分頁… & 指定 theme: kira 全站 改站名、網址、分頁數、啟用插件。
_config.kira.yml Kira 主題專屬設定(社群連結、封面、配色、元件開關) 全站 建議優先用這裡調整,不動主題原始碼。
source/about.md 自我介紹內容 /about Front-matter layout: about;內容自己寫
source/friends.md 友鏈清單資料 /friends Front-matter layout: friends;可用陣列生成卡片
source/archive.md 歸檔入口頁 /archive/archives Front-matter 指向對應 layout
source/style.css(或 source/css/_custom.styl 你的覆寫樣式 全站 用於蓋掉主題預設 CSS(最安全的客製方式)
source/js/*.js(自建) 你的覆寫/新增 JS 需你在版面引用 放「頭像旋轉」「箭頭滑動」等自訂邏輯

如果之後有要修改時不知道改哪就能回來這邊確認

明天再開始進行修改


上一篇
套用主題
下一篇
DAY7 更改背景圖片
系列文
身為一個宅宅也想要有自己的小天地7
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言